revProfile
Type
property
Summary
Specifies the current profile for an object.
Syntax
set the revProfile of <object> to <profileName>
Description
Use the revProfile property to switch sets of property values on the fly.
When you change the value of a property for an object, the value is stored in the object's current profile. If you later switch back to that profile, the stored values are restored. For example, if you create a profile named "Fluffy" for a button, then set the button's backgroundColor property to "pink", that setting of the backgroundColor property is stored with the Fluffy profile. If you later set the button's profile to "Fluffy", the pink color is restored.
If the profileName does not exist for the object, setting the profile either fails silently or creates a new profile with that name for the object. You change this setting using the gRevAutoCreateProfiles variable.
(The revProfile property is implemented as a custom property, part of the "cRevGeneral" custom property set. For this reason, you can also refer to it using the custom property set notation, as cRevGeneral["profile"].)
The revProfile property is part of the Profile library. To ensure that the property works in a standalone application, in the Profiles section on the General screen of the Standalone Application Settings window, make sure you choose to include profiles in your application.
Examples
set the revProfile of button "OK" to "French"
set the revProfile of group "Menubar" to "Short Menus"
set the revProfile of me to "Master"
if the revProfile of this stack is "LargeFont" then beep
Related
command: revSetStackFileProfile
glossary: object, property, custom property, property profile
keyword: gRevAutoCreateProfiles, gRevProfileReadOnly
library: Profile library
object: button
property: backgroundColor, customPropertySets
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile